package com.stellar.circle.basic.service;

import com.stellar.circle.basic.entity.SSchool;

import java.util.List;
import java.util.Map;

/**
 * 学校信息表(SSchool)服务接口
 *
 * @author Jqchan
 * @since 2025-05-17 18:48:36
 */
public interface SSchoolService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    SSchool queryById(Long id);

    /**
     * 条件查询单条结果
     *
     * @param condition 查询条件
     * @return 实例对象
     */
    SSchool queryByCondition(SSchool condition);

    /**
     * 条件查询全部结果
     *
     * @param condition 查询条件
     * @return 实例对象列表
     */
    List<SSchool> queryAllByCondition(SSchool condition);

    /**
     * 分页查询
     *
     * @param condition 查询条件
     * @param page      页码
     * @param pageSize  每页数量
     * @return 分页结果
     */
    List<SSchool> page(SSchool condition, int page, int pageSize);

    /**
     * 新增数据
     *
     * @param entity 实例对象
     * @return 影响行数
     */
    int insert(SSchool entity);

    /**
     * 修改数据
     *
     * @param entity 实例对象
     * @return 影响行数
     */
    int update(SSchool entity);

    /**
     * 通过主键删除
     *
     * @param id 主键ID
     * @return 影响行数
     */
    int deleteById(Long id);

    /**
     * 条件统计
     *
     * @param condition 统计条件
     * @return 总数
     */
    Long count(SSchool condition);

    /**
     * 通过经纬度获取学校列表
     *
     * @param longitude
     * @param latitude
     * @return
     */
    List<SSchool> getSchoolListByLocation(Double longitude, Double latitude);

    /**
     * 批量查询
     *
     * @param schoolIds
     * @return
     */
    List<SSchool> batchQueryByIds(List<Long> schoolIds);

    /**
     * 学校名称批量查询
     *
     * @param schoolIds
     * @return
     */
    Map<Long, String> batchQuerySchoolNames(List<Long> schoolIds);
}
